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Optrol delivers 
on 524K promise 


Finally, anaffordable U.S.-made RAM 
card with plenty of storage is available for 
the Portfolio. 

You could hear the disappointment in 
the Portfolio community when the mak- 
ers of these cards, Optrol, was initially 
unable to come through on their promise 
of i-, 2-, and 4-meg cards because of a 
small supply of the necessary chips. 

However, Optrol was able to re-engi- 
neer the cards using a different chip set 
that is more widely available. The cards 
are now only 524K, but the price is far less 
than what you’d pay for the same amount 
of RAM in standard 128K cards. 

Optrol has redesigned the card to fit 
better in the Portfolio and much better in 
the PC Card Drive (the older |-meg cards 
were too thick and had to be jiggled to 
connect properly sometimes). 

The Optrol cards are still thicker than a 
normal RAM card, but not to the point of 
distraction. 

Of course, the Portfolio needs to run 
special software to make the card run. 
Fortunately, Optrol has made it very easy 
to load and run the software. All you have 
to do is put the card in your Portfolio and 
reboot. The software runs automatically. 

All of the card’s software drivers are 


Re:Port subscribers can get 
Optrol’s 524K FlashRAM cards 
for $9 off the retail price! 

Each card includes the re- 
quired software. 

Each 524K FlashRAM card is 
only $180 for subscribers ($189 


retail price; $185 non-subscriber 
price). 

Make check or money order 
payable to: , 

Re:Port 

806-34 Benton Drive 

lowa City, IA 52246-5207 


stored on whatis calleda ‘‘bootblock’’ 
of the card. 

That boot block acts as drive A: 
and looks to your Portfolio like a 66K 
ROM card. 

There is a special program that 
allows you to overwrite the contents 
of this “‘ROM”’ card, though -- an 
excellent way to customize your 
Portfolio’s setup, anda very safe place 
to put your most important programs 
and non-changing data. 

The actual RAM card portion of 
Continued on Page 8 
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Re:Port 


From the Editor 


New products available and more are coming 


A lot has been happening here at 
Re:Port, and of course subscribers 
will benefit from all the increased 
activity. 

First of all, if you haven’t read the 
story on the front page, read it now! 
Optrol has finally released their 524K 
cards in production quantities, and 
we can pass them onto you for great 
savings. 

Because of our special free parcel 
post shipping policy and our great 
subscriber prices, you can save about 
$14 off the regular price of the cards. 

Be sure to check out the new Sav- 
ings Surge flier — it has changed this 
time around. We’ve added the 524K 
cards, and highlighted the exciting 
new Universal Interfaces from BSE. 

BSE provided us with many of 
their neat yellow fliers about their 
interfaces, which we have passed 
along to as many of you as we could. 
If you didn’t get one in this package, 
then call or write and we’ Il put you on 
a list to get one when we get more. 

Also, we have many programs on 
the way in future issues that I'd like 
you to know about. Coming up are 
Autoback, a program that can auto- 
matically back up your C: drive so 
you never lose anything, and 
SuperPrint, a .HOO file that allows 
you to print bold, underline, italics, 
and other text attributes with your 
printer and the built-in editor. 

We're always open to your sug- 
gestions, too. We have a standing 
suggestion to write a Wheel of For- 
tune game (complete with Vanna 
White graphics). Although Vanna is 
out, we’re working onthe game. Any 
other suggestions would be much 


appreciated (coming up with two or 
three new programs in a couple of 
months, along with custom Portfolio 
projects in the works, can be really 
difficult at times, especially if we 
don’t know what you really want). 

A good way to indicate what you’d 
like to see, and to win some prizes 
while you’re at it, is to enter any one 
of the Re:Port contests that we fea- 
ture in every issue. This month, the 
prize is Autobyte’s Terminal+ com- 
munications package. 

LYNX ON THE WAY 

If you’re a person who loves to 
play games on the Portfolio, you 
should consider an Atari Lynx 
handheld game system. Re:Port just 
received a Lynx and has the go-ahead 
to sell the game and all of Atari’s 
game cartridges to our interested sub- 
scribers. 4 

The Lynx is simply incredible. It 
has a color screen, a 16 Mhz, 16-bit 
processor, four channels of sound, 
and graphics capabilities built nght 
into the hardware for extreme speed. 

Youcouldtry to compare the Lynx 
to the Nintendo GameBoy, but there 
is no comparison. The Lynx is sim- 


ply superior. Its graphics ability 
even surpasses the slower Sega Game 
Gear. 


It also has more than 50 games, 
including the newest Batman Returns 
and Pit Fighter, as well as classics 
like Ms. Pac Man and Klax. 

So, if you have a child that you’d 
like to get interested in portable com- 
puting, or if you would like a game 
system to help you spend some hours 
during a boring flight, let us know. 

Inthe next couple of months, we’ Il 


look at the interest in the Lynx game 
and come up with a price list for 
subscribers that will be as eye-pop- 
ping as the game itself! 

In the meantime, keep writing and 
calling. Welike to hear from you, and 
we are always glad to try to help you 
with any problem. A recentchange in 
work schedules means that you’re 
more likely to reach someone at 
Re:Port during business hours, but 
please try to call between | p.m. and 
9 p.m. Central Time. 

And if you get an answering ma- 
chine, please leave a message with 
your name, your day number, your 
night number, and a brief description 
of your question so we can be better 
prepared when we call you back. 


Quick tip 


Accidentally delete some- 
thing ina Portfolio internal app? 
Don’t worry. 

If you have Undelete Save 
turned on (see the Setup menu 
under Applications ...), then the 
Port will allow you to undelete 
anything that you delete. 

Just move to where you 
want to put the data you de- 
leted, and press Fn-4. 

This also makes a great way 
to cut and paste! 

Just delete the information 
that you wish to cut, move to 
where you want to paste, and 
hit Fn-4. This even works be- 
tween applications (i.e. cut 
something in the editor and 
paste it in the worksheet). 


Re:Port 
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Industry News 
Run Port apps on the PC; CD-ROM possible 


The Portfolio Connection in England has announced 
the availability of PC Apps, a set of programs that allow 
your IBM-PC compatible desktop computer run the 
same programs that the Portfolio runs. | 

This helps extend the value of the Portfolio by insur- 
ing that the data you create on it can be edited easily back 
at home on a desktop PC. 

Although the program still imposes the same 55K 
limit on data files (no matter how much memory your PC 
has), it does offer complete Port compatibility. It even 
offers an easier interface to file transfer, although the 
FT.COM program must still be present. 

[It evenallows youto set alarms that sound through the 
diary program. You also have various screen size and 
placement options. 

If you think you’d find this program useful, please 
contact Re:Port. We will special order the product 
through the Portfolio Connection. When you contact us, 
we will quote you a price based on current exchange 
rates and shipping charges, which at the time of this 
writing put the price around $80 U.S. 

PORT CD-ROM HOOKUP 

Carl Bacani, formally of Atari, is looking for people 
interested in supporting a CD-ROM project for the 
Portfolio. 

The package would include a CD-ROM of Portfolio 
software that you can read with any standard ISO-9660 
drive (most [IBMs, Macs, and Ataris can read this 
format). 

Also, Bacani has had success hooking up a special 
SCSI interface to a Sony CD-ROM drive and attaching 
it straight to the Portfolio! More than 600 megs of CD 
data showed up on his Port. 

This is exciting because more than just CDs can work 
on the Port ifit has an SCSI interface. You can hook up 
hard drive, tape drives, scanners, and all kinds of other 
devices. 

Bacani expects the CD-ROM to sell for around $50. 
He is looking for people interested in supporting the 
project, and he’d also like to know whether people 
would be interested in buying the finished version. 

To express your opinion, call or write Re:Port, and 
we will forward the message via our CompuServe link. 


PORT FLOPPY DISK DRIVES 

A German company, GEMAC, is going to introduce 
a floppy disk drive controller interface that will allow 
you to read and write to 3.5" floppy disks on the 
Portfolio. 

You won’t be able to format the disks on the Port -- 
instead, you can buy them preformatted, or get them 
formatted elsewhere (they will be perfect for reading 
Re:Port disks!) 

The controller is an interface with a serial port and 
parallel port and contains an EEPROM with all the 
software that is needed. 

GEMAC also plans to offer a complete package of 
interface and your choice of floppy disk drive (it works 
with an Atari SF314 drive or a Shugart compatible 
drive). 

To find out more, contact GEMAC at: 

GEMAC mbH Chemnitz 

Matthesstr. 53 

D-O 9003 Chemnitz Germany 

CARRYING CASE 
« The hottest-selling item here at Re:Port recently has 
been the Professional Carrying Case. 

At only $40.96, this is the perfect solution for trans- 
porting the Port. 

It includes five RAM/ROM card pockets, two docu- 
mentation pockets, a pen holder, three AA battery hold- 
ers, a retractable carrying strap, and a place to clip the 
Portfolio tightly down (with an interface connected!) 

The design of this case is so good that you may never 
take the Port out of it. Simply unzip the case, flip open 
your Port, and start working. 

You can order yours from Re:Port today. We still 
also offer the regular carrying case for $34.16, which is 
a padded pouch for the Port, a few memory cards, and an 
interface (disconnected). 


Reach Port owners with an entry in Industry 
News! Send your press release to: 


Re:Port Industry News 
806-34 Benton Drive 
lowa City, IA 52246-5207 
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PBASIC 


New version improves serial communications 


(c) BJ Gleason 

After a year of avoiding the inevitable, | finally did 
what so many users wanted me to do. After I got out of 
the lake, I then added Interrupt Driven Serial Communi- 
cations to PBASIC. PBASIC 5.0 was released on 
January 18, 1993. It is available on Compuserve and 
other services, and is also included on the Re:Port disk. 

INTERRUPT-DRIVEN SERIAL COMMUNICATIONS 

The Portfolio has a non-standard serial port, and a non- 
standard Interrupt Structure. This prevents standard 
Serial Communication programs from working. PBASIC 
5.0 now uses interrupt driven communications for serial 
input. The serial input buffer is 256 characters and is not 
adjustable. Because of the speed of the Portfolio, and the 
speed of PBASIC, itisrecommended that the transmitting 
computer send nulls, or have line pauses. The output isnot 
interrupt buffered. For compatibility, the serial port 
commands are basically the same. 

There are four commands for operating the serial port: 
COMSET, COMSTAT, COMIN, and COMOUT. The 
first two concern the settings and status of the serial port. 

COMSET will set the configuration of the serial port. 
COMSET = config 

The value for config is determined by the following 
table: 

765 

Baud Rate 
000=110 
001=150 
010=300 
01 1 =600 
100= 1200 
101 = 2400 
| | 0 = 4800 
| | | = 9600 

So, if we want to set the serial port to 9600 baud, No 
Parity, 8 bits, and 1 Stop bit, we would get the following 


43 2 

Parity Stop Bits 
xO0=none 0=1 bits 
Ol=odd = | =2 bits 
| | = even 


10 

Word Length 
| 0 =7 bits 

1 | =8 bits 


pattern of bits: 
9600 No I 8 
EEE 00 0 It 


Which would be E3 hexadecimal, or 231 decimal. 
We would then use the statement: 
COMSET = 231 
to initialize the serial port. 

Now that we have initialized the serial port to the 


wom Gleason on PBASIC 


PBASIC can be found on Re:Port Disk #10 
ON DISK in the \PBASIC subdirectory. 


correct speed and protocol, we need a way to check when 
a character is in the serial port buffer. This is done by 
checking the input buffer with the COMSTAT function. 

COMSTAT will return a boolean value, either TRUE 
or FALSE. Ifthe value is TRUE, there are characters in 
the input buffer. 

For example, to see if a character is waiting to be read: 
if comstat then print “Character Waiting” 

In PBASIC 4.91 and earlier, you had to check 
COMSTAT before transmitting a character. PBASIC 
5.0 will now automatically wait ifthe previous character 
has not be transmitted. 

Now to actually send the character to and from the 
serial port, we need another function and statement. 

COMIN will read a character from the serial port. It 
will return the ASCII value (a number) of the character 
waiting in the input buffer. Why return a number? Due 
to the design of PBASIC, strings can not contain the 
ASCII value 0. In order to make sure this value would 
be received correctly, the ASCII value is returned in- 

Continued on Page 8 


About the Author 
Mr. BJ Gleason is an instructor at The 
American University in the Computer Sci- 
ence and Information Systems Department. 
He has been programming for more than a 
decade and is the author of PBASIC. 
You can write to him at: 


BJ Gleason 

The American University 

CSIS (Thin Air Labs) 

4400 Massachusetts Avenue, N.W. 
Washington, DC 20016 

CompuServe : 75300,2517 

EMAIL : bjgleas@auvm.american.edu 


Re:Port 


Featured 


Page 5 


Port Grocery Shopper is a supermarket savior 


How many times has this hap- 
pened to you: You get to the check- 
out counter at the store, the checker 
gives you your total, and you have to 
put something back because you 
don’t have enough cash? 

Or about how getting halfway 
home and realizing you forgot some- 
thing? 

Or finding out you bought a prod- 
uct you thought was good for you, 
only to find it wasn’t? Or forgetting 
a coupon? 

If those questions remind you of 
your last trip to the store, then Re:Port 
program Grocery Shopper is perfect 
for you. 

Grocery Shopper organizes your 
grocery list, keeps track of the money 
you’re spending and of your cou- 
pons, and can even do some nutri- 
tional analysis. 

To use Grocery Shopper, simply 
copy the fileGRO.EXE to your Port- 
folio and type GRO. 

The first time you run the pro- 
gram, you will be asked for your 
state’s tax, in pennies per dollar. 

If you have a 7.5 percent tax in 
your state, type 7.5. 

If your state doesn’t tax most food 
items, type 0. 

You are then asked for an alter- 
nate tax rate. Most states don’t have 
a tax on some items such as newspa- 
pers or magazines. 

Or, maybe your state has a higher 
tax on items such as cigarettes or 
alcohol products. Enter that tax rate 
here. 

At this point, the program will 
save that information but will stop 
and tell you that you must have a file 


Grocery Shopper is 
called GRO.EXE on 
Re:Port Disk #10 
under the GROCERY 
subdirectory. 


ON DISK 


called GROCERY.TXT before you 
can begin. That file is your grocery 
list. 

You can create a grocery list on 
any computer that can create an 
ASCII text file (the Port’s built-in 
editor is perfect for this task, of 
course). 

Simply type in your list, and don’t 
worry if you forget something; you 
can add it later. 

While you’ re typing in your gro- 
cery list, you will want to note 
whether you have a coupon for an 
item. 

If you do, type arr asterisk (*) by 
the item name, followed by the 
amount of the coupon. 

If you put an item on the list that 
you know will use the alternate tax 
rate, type a percent size (%) next to 
it. 

So, you may have a list that ends 
up looking like this: 

Ketchup 
Peanut Butter 
Bread 

Pepsi *.25 

PC Magazine % 
Paper towels 

In that list, we had a 25-cent cou- 
pon for Pepsi, and PC Magazine 
won’t be taxed. 

Now, gather your coupons and 
your Portfolio and head for the store. 

Quick tip: The Professional Car- 
rying Case for the Portfolio makes 


an excellent Grocery Shopper com- 
panion. You can store your coupons 
in the RAM card slots! It also pro- 
tects your Port from getting bumped 
around in the store. 

When you getto the store, youcan 
place your Portfolio on the child’s 
seat in your grocery basket, which 
makes an excellent spot for reading 
and typing. 

If you’re worried that you might 
look funny walking around a store 
typing on a computer, don’t be. 

During testing at a crowded su- 
permarket here in Lowa, not one per- 
son even took a second look at the 
Portfolio. Maybe people are getting 
more used to the idea of computers 
in our lives. 

When you load Grocery Shopper, 
it will group the list by the first letter 
of the alphabet. 

Press the Atari key for help if you 
don’t remember these instructions. 

To buy an item, find it on the list 
and press enter. You will see an 
input screen where you can enter the 
price of the item and the quantity of 
the item that you wish to purchase. 

If you buy two jars of peanut 
butter for $1.38 each, type $1.38 and 
2. Hit escape when you’re done. 

Youmay optionally enter the num- 
ber of calories and the amount of fat 
in grams that the product contains. 
The Port will then calculate the per- 
centage of calories from fat in the 
item. 

It is recommended that you try to 
stay below 30 percent. 

Many products that claim to be 
low in fat really aren’t if you look at 

Continued on Page 6 
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Ski is a fast-paced downhill distance race 


If you’re into skiing, or even if you’ re not, this is sure 
to be a game that will keep you challenged for a while. 

Ski is a downhill skiing game that is played on the 
Portfolio. To begin, copy SKI.EXE to your Port and 
type SKI. 

Your skier is represented by two vertical lines. You 
control the skier by pressing the left and right arrow 
keys. 

You want to avoid the sides of the trail, which begin 
about nine spaces apart. 

The game starts out slow. You have time to watch the 
trail go by and see the trees pass you at a leisurely pace. 
That all changes very soon. 

As you get further and further down the trail, you also 
pick up speed. Soon, the screen is flying by faster than 
you can think, and you have to act on reflexes to stay on 
the trail. If you survive, you will start going faster than 
even your reflexes can handle! 

Not only do you get faster, but the trail also gets 
smaller. You’ll never get completely squeezed out, but 
as the trail gets less wide, you have less room to 
manuever around another of your enemies -- the moguls. 

Moguls are tiny hills (represented by a caret mark on 


The Ski game is called SKI.EXE on Re:Port 
Disk #10 in the \SKI subdirectory. 


Ski! (c)Re:Port 


Distance: eat 
| 


Trail side 


the screen) that will propel you forward on line on the 
screen. The closer you are to the bottom of the screen, 
the less time you have to react to changes in the trail, and 
the more likely you are to smash into the side. 

Se far, the most distance anyone at Re:Port has been 
able to achieve is 1 047 feet. Let us know if you can beat 
that! And (don’t) break a leg. 


Continued from Page 5 


them this way. 

If the item has a coupon, the Port 
will automatically deduct the cou- 
pon and remind you with a beep that 
you should get your coupon ready. 

If you’re buying an item such as 
apples that are sold by weight rather 
than units, you can still use Grocery 
Shopper, although this will tum your 
total from an exact figure into an 
estimate, depending on how well 
you weigh the item. 

Simply weigh the item, and then 
input the price for each pound into 


the price field, and input the total 
weight in the quantity field. 

If you find an item that you wish 
to buy that isn’t on your list, just 
press N for ‘‘not on list.”’ 

If you think of an item while 
you’re in the store, but it is several 
aisles away and you don’t want to 
forget it, just press A for ‘‘add an 
item to list.”’ 

If you find out an item needs to be 
entered with the alternate tax rate, 
but you forget to put a percent sign 
next to it originally, press % and the 


Port will take this into consideration. 

The Port will place a checkmark 
on your list next to items as you buy 
them. 

To find the next unchecked item 
on a list, press F for ‘‘find.’’ This is 
good to do when you’ve finished 
shopping to make sure you have 
everything. 

Grocery Shopper also features a 
currency converter if you’re shop- 
ping in another country. Press C to 
access that feature. You will then 
enter the current exchange rate. 


Re:Port 


A:\DOSTIPS> 
Getting DOS programs to run right 


The Port will run DOS programs. 
Well, sort of. 

Everyone knows about the memory 
and storage limitations thatmake DOS 
programs a poor bet for the Portfolio. 
Most DOS programs these days ex- 
pect to find at least 512K on a ma- 
chine, or they won’t run. 

You can always limit yourself to 
the internal applications, or you could 
branch out to the Portfolio-specific 
software that you find here in Re:Port. 
But you say you’re still dying to get 
DOS programs to run on the Portfo- 
lio? Then here’s what you’ll need to 
know. 

First ofall, there are many kinds of 
programs that you can dismiss right 
away. 

Any program that uses graphics 
will not run, unless it was written 
specifically for monochrome moni- 
tors and doesn’ tuse any special graph- 
ics routines. If you know that the 
program only uses what are called 
BIOS calls to write graphics (which 
very few do), then it may be safe to 
run. Even if the program doesn’t use 
graphics, but does use color text, you 
can expect to get poor results on the 
Port. 

However, ifthe program does you 
color text, you might be able to get it 
to work somewhat on the Port by 
using the ANSLSYS system file. You 
can find it on CompuServe, or get it 
from Re:Port in a back issue. 

Any program that needs to access 
the serial port is a bad candidate for 
the Port. The Portfolio has a non- 
standard serial interface, and it needs 
to be programmed directly. Again, 


only if your program uses only BIOS 
calls (and even fewer programs do 
this than the graphics ones) will it 
work on the Port, and even that is not 
too likely. 

Obviously, anything that needs to 
use more than | 00K or sois out unless 
you have a memory expansion. Any- 
thing that needs expanded or extended 
memory, orany memory above 640K, 
is out for sure. 

Programs that rely on the system 
clock tick, which usually occurs 18.2 
times a second on a normal PC, will 
not work on the Portfolio (or at least 
they’ll be so slow you won’t be able 
to stand it) because the Port’s timer 
only ticks once every two minutes. 
You can set it to tick once every 
second, but that’s still 18 times slower 
than normal. S 

On the other hand, good candi- 
dates are any programs that deal 
strictly with text. Small utilities and 
many text-only programs and games 
will run just fine. 

When you have a program you 
think will run, the first step is always 
to back up your Portfolio. When you 
put a DOS program on the Portfolio, 
there are many things that could go 
wrong, and the program may lock up 
your machine, and cause your C: drive 
data to go away for good. So makea 
backup and expect to use it. 

Then, just try to run your DOS 
program. If you’re all backed up, it 
couldn’t hurt. The program might 
even run right away; and the worst 
that could happen is you’ll have to 
reboot and restore your backup. 

When you are running a DOS pro- 
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gram, it is a good idea to get familiar 
with the Display portion of the Setup 
menu (Atari-key S$). You’ll usually 
want to start out with the external 
display mode set to Static PC. You’ ll 
want to experiment with the refresh 
rate, but start out with it on Keys. 
Speed you will want to leave at Nor- 
mal for now. 

Ifthe program seems as though itis 
rumning, but you don’t get a good 
screen display, try first setting the 
external mode to Tracked. Then, try 
setting the refresh to Both. Run the 
program again. 

Ifit still won’t work, try setting the 
speed to Fast in the setup menu and 
running the program again. 

Be sure to scroll around the screen 
by holding down the alt key and the 
cursor keys. You may be missing a 
prompt in the middle of the screen 
that is asking you to press a key or to 
wait while the program initializes. 

Perhaps one of the best ways to 
avoid making a mistake like that is to 
run the program on your desktop PC 
while you are trying to make it run on 
the Portfolio. That way, you can see 
what the screen is supposed to look 
like, and when youare being prompted 
for input or a keypress, because con- 
trary to what you may think, the 
Tracked mode does not always track 
the cursor exactly as the programs 
expect you to enter data. 

With enough determination, pa- 
tience, and storage space, you can get 
all kinds of DOS programs to work 
with the Port. Let us know what you 
get running, and what you had to do 
to make it work. 
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the card (the part you can read and 
write to) is drive D: on your Port. 

One important thing to note is that 
this 524K card is not really a RAM 
card, but rather a FlashRAM card. 
There are a few differences, the most 
positive one being that the card can 
retain data for 10 years without bat- 
teries. The other big advantage is the 
price per K, whichis obviously much 
lower in this card. 

There are some negative aspects, 
though. Luckily for the end user, 
Optrol has made this negative as 
transparent as possible. 

FlashRAM disks to not allow 
you to overwrite a file, but rather a 
file is ‘‘hidden’’ and re-written to a 
different part of the disk. This has 
no noticeable effect to the user (i.e. 
your file is still correct), except that 
the card can fill up very quickly if 
you do a lot of editing. 

Look at it this way. Let’s say you 
have a SK address book file called 
BUSIL.ADR stored on your 
FlashRAM card, and 100K of free 
space still left on the card. You 
decide to edit a mistyped phone num- 
ber in the .ADR file and save it. 
Now, you have the corrected 
BUSLADR file still at SK on your 
card, but only 95K of free space left. 

Optrol has provided a program 


PBASIC 


Optrol 524K cards 


called CLEAN that takes about five 
minutes to run. The card’s driver 
software will tell you when it is time 
to think about CLEA Ning your card, 
and it is recommended that you do so 
immediately. 

The CLEAN command will free 
up all the space that should be free, 
and you will be able to write files to 
that space. In the above example, 
you would be returned to 100K of 
free space (assuming that was the 
only wasted space on the card). 

Furthermore, the Optrol card in- 
cludes the option to create a tempo- 
rary 128K RAM disk on your Port- 
folio, which acts asthe E: drive. You 
can use this disk if you wish to do a 
lot of editing and saving to a file, so 
you don’t waste space on the card. 
Then, when you do the final edit, you 
can save the file directly to the card. 

The E: drive is very handy, but it 
goes away if the Portfolio should 
power down at any time (although it 
will survive a warm boot). You can 
get programs to prevent the Portfolio 
from powering down by calling 
CompuServe or Re:Port, but Optrol 
is considering adding that feature to 
the card software. 

For you PC Card Drive users, 
there is also software on the card for 
you! Simply install the software 
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drivers into your CONFIG.SYS file 
and reboot your desktop computer, 
and you can read and write to the 
524K card on the PC Card Drive. 
This makes for excellent file ex- 
change between the Port and the PC. 

You cannot CLEAN the card or 
use the 128K temporary RAM disk 
with the PC Card Drive. 

In testing, Re:Port found that the 
card would not work with the 512K 
internal RAM of the BSE Universal 
Interface. Optrol is looking into the 
problem. 

Until that problem is fixed, it is 
difficult to use the card in conjunc- 
tion with larger memory to run big 
DOS programs. 

Still, the card is incredibly valu- 
able for storing all of your Portfolio 
programs and data in one secure 
place. Because it doesn’t run on 
batteries, you can be assured that 
your data is safe. Just be sure to 
CLEAN thecard often enough (prob- 
ably once a week at the very least), 
and you’ ll have plenty of space. 

Of course, Re:Port offers these 
cards to subscribers at a discount of 
$9 less than retail. And you get free 
shipping, which can save you an- 
other $5. 524K Cards are $180.00 
from Re:Port, 806-34 Benton Drive, 
lowa City, [A 52246-5207. 


stead of the character. To print the 
actual character, use the CHR$() 
function. To just read and display 
characters coming in the serial port: 
| if comstat then 

a=comin :‘ read character 

print chr§(a); : ‘ print it 


endif 
goto | 

To transmit a character, the state- 
ment COMOUT is used. This also 
requires an ASCII value. You can 
get the ASCII value of a character 
using the ASC() function. 


Included on the disk is a complete 
listing for a simple terminal program, 
TERMINAL.BAS. I have used this 
program to connect to Compuserve at 
speeds up to 9600 baud. 

So there is it. And if you don’t 
mind, I’ ll get back into the lake now... 


Re:Port 
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Beginner’s Column 


How to unarchive files, from .ARC to .ZIP 


This issue’s column is in response 
to a letter from Dr. Baxter Paschal of 
Fayetteville, North Carolina. 

He writes: ‘‘I think it would be 
nice if you published, or republished 
as the case may be, an article on how 
to download and use files from 
CompuServe that end in .ARC and 
.ZIP. [| know that they are archived 
and zipped but really don’t under- 
stand what programs I have to have 
to unzip or unarchive them.”’ 

That’s a good question. Many 
people are confused by what .ARC 
and .ZIP files are (we will also cover 
another popular format, .LZH), es- 
pecially if they have not been using 
modems long. 

The files are usually groups of 
files that have been compressed and 
placed into a single file for ease of 
downloading with amodem. Before 
these formats were common, you 
used to have to download a program, 
all of its data files, and its documen- 
tation separately. Now, all of these 
files are usually placed in a single 
file called an archive. 

The last three letters of the 
filename (.ARC, .LZH, or .ZIP) in- 
dicate what type of program was 
used to create the file. All three of 
these archive formats also happen to 
do file compression, a process that 
makes a file smaller by replacing 
repeated data with a single code. 
This compression, which can some- 
times be around 50 percent or more, 
helps keep your downloading time at 
a minimum. 

In order to get at the files that are 
contained within the archives, you 
will need the specific program that is 


related to the last three letters. 

There are many programs that 
can process these files for you. The 
most popular programs aRe: 

ARCE -— for extracting .ARC 
files 

LHA — for extracting .LZH 
files 

PKUNZIP -- for extracting 
-ZIP files. 

In the United States, you could 
get by quite well with just 
PKUNZIP, which is contained in a 
file usually called PK ZIP204.EXE. 
Within the past five years, most 
archives have been converted from 
.ARC to .ZIP. About 90 percent of 
all IBM-PC downloads are likely to 
be zipped. 

To get copies of those programs, 
search for them using the IBM File 
Finder (GO ‘IBMFF) on 
CompuServe. (ARCE and other 
extractors for other file types, such 
as the increasingly popular .ARJ are 
available directly on _ the 
APORTFOLIO forum). 

One thing to note: Decompres- 
sion can take a lot of memory and a 
lot of disk space. It is not recom- 
mended that you try to unarchive 
files on your Portfolio. You should 
get the programs onto your desktop, 
run the unarchiving program, and 
then transfer the resulting files onto 
your Portfolio. 

Also, many of the files contained 
in the archive will not be necessary 
to place on your Port, but are nice to 
have around. For example, almost 
all archives include a documenta- 
tion file that is not necessary to have 
on the Port, so you should leave it 


off to save space. 

If you must unarchive files on the 
Portfolio, you should restrict your- 
self to ARCE and .ARC files, be- 
cause the program takes up less 
memory and the resulting files are 
typically smaller (owing to the fact 
that.ARC files are, in general, older). 

Of course, each of the programs 
has its own way of extracting the 
archives. 

Programs that extract the .ARC 
and .LZH files usually require that 
you tell then to extract with an E or 
an X on the command line, such as: 

LHA E ARCHIVE.LZH 

PKZIP, on the other hand, has 
separate programs for compressing 
and decompressing archives, and 
therefore it knows that you want to 
extract by virtue of the program that 
you run. For example: 

PKUNZIP ARCHIVE.ZIP 

Also depending on the program, 
you will not have to type the period 
and the last three letters, although it 
never hurts. 

Youmay also hear about PKLITE 
and LZEXE, which perform com- 
pression on .EXE files. Those are 
not archiving programs, but rather 
they compress only one file at a time 
in order to save space on a disk. 
Their performance is transparent to 
the end user, and you do not need a 
special program to process a file that 
has been compressed in this manner. 


Please send you questions to: 
Re:Port Beginner's Column 
806-34 Benton Drive 

Iowa City, IA 52246-5207 
Describe your problem in detail. 
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Re:Port 


Advanced Pro 


ramming 


Professional Port input controls made easy 


If you look in the \SOURCE di- 
rectory of your Re:Port disk, you'll 
find a file called EDITBX.PAS. 

That is the source code for a vari- 
ety of functions that are accessed by 
Interrupt 60H on the Portfolio, pri- 
marily the line editor and the menu 
system. 

In this column, we’!l focus on the 
line editor control structure, the 
knowledge of which can be used to 
create very professional input con- 
trols in your programs, no matter 
what language you program in. 

More details on this information 
can be found in the Portfolio Techni- 
cal Reference Guide, available to 
Re:Port advanced readers for $60. 

The edit control structure is a large 
record-type variable that defines the 
look and feel of the line that the user 
will type his or her input on. It 
includes many options, and appar- 
ently was built for expandability. 

For an example of what the edit 
control can do, see the grocery pro- 
gram in this issue. In the item pur- 
chase screen, you see that you can 
prompt the user with a value, and 
easily restrict that input to whatever 
length you wish. If you want to 
allow an input that is longer than the 
Port’s screen, the edit control will 
handle scrolling for you automati- 
cally. 

A more common example is the 
box that pops up when you load or 
save a file in one of the internal 
applications. 

Let’s take a look at this structure, 
along with some tips for its use: 

First is a double-word-sized 
pointer to the zero-terminated string 


Source code to 
Re:Port programs 
can be found on 
Re:Port disk #10 in 
the \SOURCE 
directory 


Bes 
>. 


ON DISK 


that will be the result of the opera- 
tion. If you want to prompt the user, 
you can put your own string here 
before you call the operation. 

Next is a word that indicates the 
position, beginning at zero, that you 
wish to begin editing the text in the 
string. If you pass the length of the 
string to this variable, then input will 
begin at the position right after the 
end of the string. 

After that is a word to indicate the 
maximum length of the string. 

Then, we have a byte each for the 
X and Y positions of the box, with 
the upper corner being 0,0. 

The mode byte is next. Setting 
this to 2 will clear the string if the 
user starts type (like in the File Load 
box). However, ifthe user hits back- 
space, the string is not cleared. If it 
is set to 0, the string is not cleared at 
all. 

A word called hit is next, which is 
the key that must be pressed before 
processing auser’s keypresses. Typi- 
cally, this would be set to 0 to cancel 
the function. 

Next is a double-word-pointer to 
the title of the box in the form 
TITLE,0,PROMPT,0,0. Note the 
double-zero termination. Prompt can 
be any string or character that will 
precede the user’s input. 

Next is a pointer to an array of 
word-sized keycodes that will cause 


the edit control to exit. The keys are 
represented with 0 in the upper byte 
and the ASCII value in the lower 
byte. 

Nextis a pointer to the routine that 
will handle keypresses. This gives 
you an opportunity to process keys 
in a variety of ways. 

Next is a byte for the maximum 
width of the edit field. Anything 
longer than this will cause a scroll. 

Then we have a byte for the type 
of edit control. 0 for a single-line 
box, | for a double-line box, and 255 
for no box. 

The next eight bytes are reserved 
for future expansion. 

The following eight bytes are a 
pointer to an undelete routine, which 
is called every time a character is 
deleted. If you don’t want to bother 
with an undelete routine, then sim- 
ply have this pointer point to a RET 
FAR instruction. 

You can see ah example of all this 
in the EDITCONTROL record of 
the EDITBX.PAS unit. 

Mostly, the advantages of using 
this interface rather than writing your 
own are threefold: 

1. It saves memory. 

2. It looks similar to other Portfo- 
lio routines, which makes your pro- 
gram blend in, making it more apt to 
be used. 

3. It allows the text to scroll, 
giving you an easy way to allow 
input that is far greater than the 40 
characters that the screen would nor- 
mally allow. 

Please drop Re:Port a note if you 
have trouble programming the edit 
control. 


Re:Port 
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Online Services 


Team creates Big Port you can download 


A team of programmers on CompuServe has created 
a software package that allows you to use your PC 
compatible desktop computer’s monitor and/or key- 
board with your Portfolio. 

BJ Gleason and Don Messerli have been working on 
the project fora while, and finally finished whatis a truly 
unique software-only solution for people who are tired 
of typing on the Port’s screen. 

You install software on your PC and on the Portfolio, 
and then connect the two with a serial interface and null 
modem cable. Whatever you type on the Portfolio 
shows up on the IBM screen. If you choose, you may 
also use the IBM keyboard, so that what you type on the 
keyboard is processed on the Portfolio and displayed on 
the PC screen. 

Some people may wonder what the point is -- you’re 
taking a 386 or 486 computer with SuperVGA and using 
itto run an 8088 Port? However, it does have great value 
to people who are more comfortable with the Portfolio’s 
internal applications than with the programs on the PC. 
It also offers a rest for people who are tired of typing on 


Contest 


eas Catalogues of the new files avail- 
>. able on CompuServe and GEnie 

J are available on your Re:Port Disk 

ON DISK #10 in the \ONLINE directory. 


CompuServe wants all Re:Port readers who aren't 


members to sign up now, so they’ve put forward a 
special offer to our subscribers. 

You can get a sign-up kit and $15 worth of free 
connect time by calling (800) 848-8199 (ask for 
Operator 198). Tell them that you heard about this 
from Re:Port, an APORTFOLIO forum member. 


the Port’s keyboard when they have a perfectly good PC 
keyboard to type on. 

Italso is a technical marvel that is just fun to see work. 

If you’re interested, you can get it on the 
APORTFOLIO forum on CompuServe. 

On GEnie, Sunday night chats continue from 10 p.m. 
Eastern till whenever. GEnie also has an active message 
base and is a good place to pick up use Port systems and 
parts. 


Get online with this incredible Re: Port giveaway 


The winner of last issue’s contest is Dr. Baxter 
Paschal of North Carolina. He gets an animation of his 
name, which is on Re:Port disk #10 in the \WINNER 
subdirectory. 

The next prize is a great one yet again. We’re giving 
away acopy of Autobyte’s Terminal Plus ROM card for 
the Portfolio. 

This incredible communications package includes 
VT-100 terminal emulation, so you can connect to your 
corporate computer with ease. 

To enter, send the form to the right to: 

Re:Port Contest #10 

806-34 Benton Drive 

Iowa City, [A 52246-5207 


fe ee ee ee ee See ae ee ss | 
| Re:Port Contest #10 | 
| Name: | 
Favorite use of the Portfolio: l 
| Favorite application (pick two): : 
l Editor Worksheet Address Book | 
| Diary Calculator | 
I esas MRS einem: etc esl “iiaoes Unhibn: itip Seiet AMS pty: Seielled apenas eels’ cisdilin: caps alt 


Or, you may call 1-319-354-6893 and leave a mes- 
sage. Or leave amessage on CompuServe to 73770,2021 
or on GEnie to DAVESTEWART. 
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Dear Re:Port, 

First, congrats on an excellent 
newsletter! I had thought the Port had 
had its day till I got Re:Port and 
learned how much is still going on 
around it. In particular, as a scribbler 
accustomed to waiting months to get 
something in print, I count it an all- 
time record that my query about the 
Port clock, mailed to you on Dec. 20, 
1992, appeared in an issue which 
reached me Jan. 7, 1993. Long may 
you flourish, unlike the last Port User’s 
group I joined (in the UK), which 
went belly-up after two issues. 

Thanks for the answer (note: the 
last letter was about problems with 
the Port’s clock losing time), though 
I still have questions, because (a) ona 
Tandon PAC { have used, with a 
system battery, there was no notice- 
able loss of time, (b) the loss of time 
on the Port has typically been a sud- 
den drop of several minutes, and (c) 
my current Portis proving mea liar by 
never losing time over several months! 

I am also surprised at the advice to 
get rid of File Manager, which for me 
has made a crucial difference in mak- 
ing file access acceptably fast (by- 
passing the Z menu habit of always 
loading your last-used file even though 
you may need a different one). 

—Parig Digan 
Hampstead, London 

[Editor’s reply: Thanks! I’m 
glad you’re happy; we plan to keep 
this going as long as there are Port 
users who are interested. We’re about 
to have our second anniversary! 

About the system time: There still 
could be a number of reasons that one 
computer loses time and another 
doesn’t. Perhaps one computer’s in- 
ternal counter, which is used to up- 


date the clock, is a shy slow, and over 
time the effect adds up to a noticeable 
loss. Or, maybe you’re using more 
reliable batteriesnow. Maybe you’ ve 
switched from fastmode to slow mode 
too often, which can confuse the Port’s 
internal clock. On things like this, 
though, you can never tell. Just keep 
an eye on the clock and update the 
time every day or every other day to 
keep it on track. 

Re:Porthas alwaysrecommended 
removing the File Manager program, 
although it does have the value that 
you point out. Still, it uses memory 
that many external programs need. If 
you are only going to use your Portfo- 
lio to run the internal programs, then 
File Manager is probably the best 
way to go. 

However, there are ways around 
the problem you mention. For ex- 
ample, you could use Re:Port’s 
Launch program, which does the same 
thing with less internal memory. 

It all depends on the uses you have 
for your Portfolio. Our main recom- 
mendation will always be to use 
whichever programs make you feel 
mostcomfortable and keep youhappy 
with the Port.] 


Dear Re:Port, 

In reply to my last letter you told 
me that you are interested in the cir- 
cumstances that make me unhappy 
with the B&P memory module (avail- 
able from the German company 
Becker & Partner). 

I started to copy all kinds of data to 
a l-meg memory module. Usually, 
there were no errors. But when I tried 
to copy a big file using the FT.COM 
program, it simply crashed, destroy- 
ing data that was already copied to the 


Re:Port 


card. 

I called the B&P “‘hotline’’ but 
nobody could believe the story. They 
simply denied that this type of error 
could occur. 

I sent the module back, and they 
returned it with the simple advice: 
**Never put more than 64 files in the 
root directory of A:”’ (I never did 
something like that!) 

It took two further attempts to re- 
pair the module before B&P sent me 
a new one. 

This one seems to be OK, although 
I already had some Exec Errors with 
it. What makes mereally angry about 
the whole thing is the very poor sup- 
port of the so-called ‘‘hotline’’ of 
B&P. Nobody ever took the problem 
seriously or even tried to assume an 
error with their product. 

I also have discovered a very inter- 
esting little utility for the Port: 
**PortWalk Interface,”’ developed and 
distributed by a young Czech engi- 
neer. 
It’s a modified printer plug that 
attaches to the parallel interface and a 
cable witha plug that youcan connect 
with your Walkman or any other tape 
recorder. 

The software for this consists of 
two rather small files for backing up 
and restoring data on a normal cas- 
sette. 

The price for this really well-done 
and 100% safe backup utility: About 
$60! I use PortWalk very often; it 
works tomy full contentment although 
it’s not too fast in restoring data from 
tape-to-Port. 

For more information, contact: 
ABAK, CS-190 16 Praha 9, CSFR. 

— Wolf-Theo Holl 
Germany 


